3D Images/3D Images.iso/programs/amiga/mpegutils/mpeg.man

Text File | 1995-01-12 | 13KB | 331 lines

MPEG(1)                                                   MPEG(1)


NNAAMMEE
       mpeg - MPEG compression and decompression

SSYYNNOOPPSSIISS
       mmppeegg [[--dd]] [[--NNTTSSCC]] [[--CCIIFF]] [[--QQCCIIFF]] [[--PPFF]] [[--NNPPSS]] [[--MMBBPPSS mmbbppss]]
       [[--UUTTCC]]
            [[--XXIINNGG]] [[--DDMMVVBB]] [[--MMVVNNTT]]
            [[--aa SSttaarrttNNuummbbeerr]] [[--bb EEnnddNNuummbbeerr]]
            [[--hh HHoorriizzoonnttaallSSiizzee]] [[--vv VVeerrttiiccaallSSiizzee]]
            [[--ff FFrraammeeIInntteerrvvaall]] [[--gg GGrroouuppIInntteerrvvaall]]
            [[--44]] [[--cc]] [[--ii MMCCSSeeaarrcchhLLiimmiitt]] [[--oo]] [[--pp PPiiccttuurreeRRaattee]]
            [[--qq QQuuaannttiizzaattiioonn]] [[--rr TTaarrggeett RRaattee]]
            [[--ss SSttrreeaammFFiillee]]  [[--xx TTaarrggeett FFiilleessiizzee]] [[--yy]]
            [[--zz CCoommppoonneennttFFiilleeSSuuffffiixx ii]]
            CCoommppoonneennttFFiilleePPrreeffiixx11 [[CCoommppoonneennttFFiilleePPrreeffiixx22 CCoommppoonneenntt--
       FFiilleePPrreeffiixx33]]

DDEESSCCRRIIPPTTIIOONN
       _m_p_e_g    is    a   multimedia   image   sequence   compres-
       sion/decompression program that performs MPEG encoding and
       decoding.


OOPPTTIIOONNSS
       --NNTTSSCC  indicates  that the source frame size for the Lumi-
              nance component is 352x240 and for the  Chrominance
              components is 176x120. This is the default size.

       --CCIIFF   indicates  that the source frame size for the Lumi-
              nance component is 352x288 and for the  Chrominance
              components is 176x144.

       --QQCCIIFF  indicates  that the source frame size for the Lumi-
              nance component is 176x144 and for the  Chrominance
              components is 88x72.

       --PPFF    indicates  that the component sizes specified by --hh
              and --vv are not multiples of 16 and furthermore that
              the input files (or output files) should be exactly
              that specified by the component size --hh and --vv  (or
              as read from the compressed stream).  Otherwise the
              input and output files will be the  component  size
              rounded up to a multiple of 16 in each dimension.

       --NNPPSS   The NPS option allows the encoder to encode without
              having the restriction that the last macroblock  in
              a  slice  cannot  be skipped.  For coding purposes,
              the first macroblock in  a  slice  must  be  coded,
              although the decoder will probably handle that case
              as well.

       --MMBBPPSS  This specifies the macroblocks per slice.  If  left
              unspecified  then  the  number  of  macroblocks per
              slice is the number of macroblocks on  one  row  of



                           14 June 1993                         1





MPEG(1)                                                   MPEG(1)


              the image.

       --UUTTCC   Forces  the  frame number of the image to match the
              Group-of-Pictures time code.  Only useful  for  the
              decoder.

       --XXIINNGG  enables  XING  compatible  encoding for intra-frame
              only files for  the  XING  decoders.   May  not  be
              robust,  but  eventually XING encoders and decoders
              will become more MPEG  compatible.  This  specifies
              160x120  encoding (apparently the defacto) for XING
              decoders.  If  you  wish  to  overide  the  160x120
              encoding  for  XING image format, use the --hh and --vv
              options after the --XXIINNGG option.  By default --PPFF  is
              always selected with -XING option.

       --DDMMVVBB  denotes  Dynamic  Motion  Vector  Bounding.  Should
              reduce the overall bits spent in the motion vectors
              if  set.   Generally  doesn't  do that much for the
              default settings, but  changing  the  search  limit
              will automatically enable the dynamic motion vector
              bounding feature.

       --MMVVNNTT  disables the motion vector telescoping.   Generally
              telescoping is a big gain when the search window is
              small, though if the  search  window  grows  large,
              telescoping may not be beneficial.

       --aa     denotes  the following value to be the start of the
              filename index [inclusive]. Defaults to 0.

       --bb     denotes the following value to be the  end  of  the
              filename index [inclusive]. Defaults to 0.

       --dd     enables  the  decoder.  The only options useful for
              the decoder are the filename specifications and the
              --NNPPSS,,  --UUTTCC commmands; the rest of the command-line
              information is used for encoding.

       --hh     is the horizontal size of the picture in  terms  of
              the  luminance  component,  used  for  a non --NNTTSSCC,,
              --CCIIFF,, --QQCCIIFF filesize.  See the preceding note about
              --PPFF  about  the  dimensions of the file relative to
              that of the component.

       --vv     is the vertical size of the picture in terms of the
              luminance  component,  used  for a non --NNTTSSCC,, --CCIIFF,,
              --QQCCIIFF filesize.  See the preceding note  about  --PPFF
              about  the  dimensions of the file relative to that
              of the component.

       --ff     is the number of interpolated frames  between  each
              intra/predicted frame.  FFrraammeeIInntteerrvvaall--11 is the num-
              ber  of  interpolated  frames  within  each   frame



                           14 June 1993                         2





MPEG(1)                                                   MPEG(1)


              interval.

       --gg     is  the  number  of  frame  intervals per group-of-
              pictures.  With a group interval of  1  then  there
              are no predicted frames.  The value GGrroouuppIInntteerrvvaall--11
              is the number of predicted frames in each group  of
              pictures.

       --44     is  used  to  DC  Intraframe mode where only the DC
              components of each picture block is coded.

       --ii     is the diameter of the  motion  estimation  search.
              The  diameter  must  be  be  positive.  The default
              value is 15 for a search window of approx (+-  7.5,
              +-  7.5).   The motion estimation is telescopic for
              frame distances  greater  than  1  (thus  having  a
              greater  effective  range).   The telescopic motion
              estimation can be turned off  by  the  --MMVVNNTT  flag.
              This  option  can  now have a value greater than 15
              but less than approximately 960.  For large  values
              the estimation becomes very slow.

       --oo     signals  that the program interpreter will read the
              control algorithms from the standard input.

       --pp     specifies the  picture  rate  by  a  code  directly
              placed  into  the  stream.   It  must  be  a number
              between 0 and 8. (default 5=30Hz).

       --qq     gives a value for the quantization not in the pres-
              ence  of  rate  control (rate control automatically
              changes the quantization values).  If rate  control
              is  specified, this parameter gives a value for the
              initial quantization of the first frame (which  the
              program usually takes an educated guess at).

       --rr     specified  a  rate for the coded stream. If this is
              enabled, a buffer model is used to limit  the  size
              of  the  coding  stream. Note this is given in bits
              per second.

       --ss     specifies the filename to store the coded image. If
              unspecified   it   defaults   to  CCoommppoonneennttFFiilleePPrree--
              ffiixx00..mmppgg..

       --vv     designates that quantization decisions  are  to  be
              written  to  standard  output.  This is the verbose
              mode.

       --xx     gives a target filesize for the compressed  stream.
              This  overrides  the  rate option --rr,, if specified.
              This is specified in bits.  The actual  implementa-
              tion  of  this technique is through calculating the
              equivalent bit-rate. Since the buffer  usually  has



                           14 June 1993                         3





MPEG(1)                                                   MPEG(1)


              some contents at the end of coding, the final file-
              size is larger than actually designated.

       --yy     enables the double-precision floating point  Refer-
              ence DCT. The default is the Chen DCT.

       --zz     denotes  the  component file suffixes in sequential
              order. For example
               --zz ..yy..ccllrr --zz ..uu..ccllrr --zz ..vv..ccllrr indicates  that  the
              luminance  and the two chrominance files end with a
              suffix of  ..yy..ccllrr,,  ..uu..ccllrr,,  and  ..vv..ccllrr,,  in  that
              order.  If unspecified, the suffixes default to ..YY,,
              UU,, and ..VV..

       CCoommppoonneennttFFiilleePPrreeffiixx_n
              must be specified. In general, the other  component
              files  share  the  same  prefix and will default to
              CCoommppoonneennttFFiilleePPrreeffiixx11 if not  explicitly  specified.
              However,  in  some cases the prefix is what changes
              in the file and we can specify this individually.


EEXXAAMMPPLLEESS
       To encode a set of raw raster scan YCbCr  (also  known  as
       digital  YUV) files with dimension 352x240 Y, 176x120 U,V,
       with labels, hheelllloo00..YY hheelllloo00..UU hheelllloo00..VV,, hheelllloo11..YY hheelllloo11..UU
       hheelllloo11..VV,,  ......,,  hheelllloo1122..YY hheelllloo1122..UU hheelllloo1122..VV through the
       mpeg encoder, type

       mmppeegg --aa 00 --bb 1122 hheelllloo --ss hheelllloo..mmppgg

       This creates the  output  file  hheelllloo..mmppgg..   In  order  to
       decode  such  a  file  into a sequence of image files with
       prefix ggooooddbbyyee,, type

       mmppeegg --dd --ss hheelllloo..mmppgg ggooooddbbyyee

       The output will be placed in the  files  ggooooddbbyyee00..YY  ggoooodd--
       bbyyee00..UU  ggooooddbbyyee00..VV,, ggooooddbbyyee11..YY ggooooddbbyyee11..UU ggooooddbbyyee11..VV,, ......,,
       ggooooddbbyyee1122..YY   ggooooddbbyyee1122..UU   ggooooddbbyyee1122..VV..    These    image
       sequences  can  be displayed by the _c_v program.  The image
       sequences can also be converted to ppm  and  back  through
       the  programs _c_y_u_v_2_p_p_m and _p_p_m_2_c_y_u_v Those utility programs
       available     by     anonymous     ftp     from      _h_a_v_e_-
       _f_u_n_._s_t_a_n_f_o_r_d_._e_d_u_:_p_u_b_/_c_v_/_C_V_v_1_._2_._1_._t_a_r_._Z_.   There  are  more
       options within an internal  program  interpreter.   Please
       see  the  accompanying  documentation  in  _d_o_c_._p_s for more
       details.


FFTTPP
       _m_p_e_g  is   available   by   anonymous   ftp   from   _h_a_v_e_-
       _f_u_n_._s_t_a_n_f_o_r_d_._e_d_u_:_p_u_b_/_m_p_e_g_/_M_P_E_G_v_1_._2_._t_a_r_._Z_.




                           14 June 1993                         4





MPEG(1)                                                   MPEG(1)


BBUUGGSS
       Somewhat  slower  than  many  commercial  implementations.
       Please inform the author at [e-mail] if  any
       bugs are found.


AAUUTTHHOORR
       Andy Hung

















































                           14 June 1993                         5